Cómo resolver reCAPTCHA v2 en Relevance AI con integración de CapSolver

Relevance AI es una plataforma para construir agentes de IA que automatizan flujos de trabajo empresariales reales, como generación de leads, extracción de datos, envío de formularios y enriquecimiento de CRM.

En la práctica, estos agentes a menudo necesitan interactuar con sitios web protegidos por CAPTCHA. Es aquí donde la automatización suele fallar: se requiere intervención manual y los flujos de trabajo dejan de escalar.

CapSolver resuelve este problema permitiendo que las herramientas de Relevance AI resuelvan desafíos de CAPTCHA de forma programática y envíen los tokens requeridos como parte de un flujo automatizado.

En esta guía, explicaremos cómo construir una herramienta de Relevance AI que resuelva reCAPTCHA v2 y envíe el token a un formulario protegido, sin depender de la automatización del navegador.

¿Qué es Relevance AI?

Relevance AI es una plataforma para construir y desplegar agentes de IA que automatizan tareas empresariales. Con su poderoso Tool Builder, los equipos pueden crear herramientas de automatización personalizadas usando JavaScript, Python o llamadas a API, sin necesidad de infraestructura compleja.

Características clave

¿Qué es CapSolver?

CapSolver es un servicio líder de resolución de CAPTCHA que proporciona soluciones basadas en IA para evitar diversos desafíos de CAPTCHA. Con soporte para múltiples tipos de CAPTCHA y tiempos de respuesta rápidos, CapSolver se integra sin problemas en flujos de trabajo automatizados.

Tipos de CAPTCHA soportados

• reCAPTCHA v2 (basado en imágenes e invisible)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• Otros mecanismos de anti-bot y CAPTCHA ampliamente utilizados

¿Por qué integrar CapSolver con Relevance AI?

Al construir agentes de Relevance AI que interactúan con sitios web protegidos, los desafíos de CAPTCHA bloquean su automatización. Estas son las razones por las que esta integración es importante:

1. Automatización completa de formularios: Resolver CAPTCHAS y enviar formularios en una sola herramienta
2. Sin navegador requerido: Funciona mediante llamadas a API, sin necesidad de Selenium, Playwright u otras automatizaciones de navegador
3. Operaciones escalables: Manejar flujos de trabajo protegidos por CAPTCHA a gran escala
4. Costo efectivo: Pagar solo por CAPTCHAS resueltos con éxito
5. Altas tasas de éxito: Alta precisión en reCAPTCHA v2

Guía de configuración

Paso 1: Obtén tu clave de API de CapSolver

1. Regístrate en capsolver.com
2. Usa el código de bonificación RELEVANCEAI para obtener un 6% adicional en cada recarga

3. Copia tu clave de API desde el panel de control (comienza con CAP-)

Paso 2: Agrega la clave de API a Relevance AI

1. Inicia sesión en Relevance AI

2. Ve a Configuración (icono de engranaje) → Busca la sección Claves de API
   
   

3. Agrega un nuevo secreto:

   • Nombre: capsolver_api_key (o cualquier nombre que prefieras)
   • Valor: Tu clave de API de CapSolver
     

4. Guarda el secreto

Paso 3: Crea una nueva herramienta

1. Ve a Herramientas en la barra lateral izquierda
2. Haz clic en Crear herramienta
3. Nombra tu herramienta: "Resolver reCAPTCHA v2"
4. Añade una breve descripción

Creando la herramienta para resolver reCAPTCHA v2

Añade parámetros de entrada

Haz clic en Texto para añadir dos entradas de texto:

Entrada 1:

• Nombre: website_url
• Descripción: URL de la página con CAPTCHA
• Requerido: Sí

Entrada 2:

• Nombre: website_key
• Descripción: La clave del sitio reCAPTCHA (40 caracteres)
• Requerido: Sí

Añade un paso de JavaScript

Haz clic en JavaScript en la sección de pasos y pega este código:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveRecaptchaV2(websiteUrl, websiteKey) {
    // Paso 1: Crear tarea de resolución de CAPTCHA
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();

    if (createData.errorId !== 0) {
        return {
            success: false,
            error: createData.errorDescription,
            token: null
        };
    }

    const taskId = createData.taskId;

    // Paso 2: Consultar solución (cada 2 segundos)
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            return {
                success: true,
                token: pollData.solution.gRecaptchaResponse,
                error: null
            };
        }

        if (pollData.status === 'failed') {
            return {
                success: false,
                error: pollData.errorDescription,
                token: null
            };
        }
    }

    return {
        success: false,
        error: 'Tiempo de espera agotado esperando por la solución',
        token: null
    };
}

return await solveRecaptchaV2(params.website_url, params.website_key);

Nota: Reemplaza {{secrets.capsolver_api_key}} con el nombre real de tu secreto si es diferente (por ejemplo, {{secrets.chains_cap}}).

Prueba la herramienta

Usa la página de demostración de reCAPTCHA de Google para probar:

• website_url: https://www.google.com/recaptcha/api2/demo
• website_key: 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-

Haz clic en Ejecutar herramienta y espera 10-30 segundos. Deberías ver:

{
  "success": true,
  "token": "03AGdBq24PBCbwiDRaS_MJ7Z...",
  "error": null
}

Ejemplo completo: Resolver + Enviar formulario

Aquí tienes una herramienta más avanzada que resuelve el CAPTCHA Y lo envía para verificar:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function solveAndSubmit(websiteUrl, websiteKey) {
    // Paso 1: Crear tarea de resolución de CAPTCHA
    const createRes = await fetch('https://api.capsolver.com/createTask', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
            clientKey: CAPSOLVER_API_KEY,
            task: {
                type: 'ReCaptchaV2TaskProxyLess',
                websiteURL: websiteUrl,
                websiteKey: websiteKey
            }
        })
    });

    const createData = await createRes.json();
    if (createData.errorId !== 0) {
        return { success: false, step: 'create', error: createData.errorDescription };
    }

    const taskId = createData.taskId;
    let token = null;

    // Paso 2: Consultar solución
    for (let i = 0; i < 60; i++) {
        await new Promise(function(resolve) { setTimeout(resolve, 2000); });

        const pollRes = await fetch('https://api.capsolver.com/getTaskResult', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                clientKey: CAPSOLVER_API_KEY,
                taskId: taskId
            })
        });

        const pollData = await pollRes.json();

        if (pollData.status === 'ready') {
            token = pollData.solution.gRecaptchaResponse;
            break;
        }
        if (pollData.status === 'failed') {
            return { success: false, step: 'poll', error: pollData.errorDescription };
        }
    }

    if (!token) {
        return { success: false, step: 'timeout', error: 'Tiempo de espera agotado' };
    }

    // Paso 3: Enviar formulario con el token
    const submitRes = await fetch(websiteUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
        body: 'g-recaptcha-response=' + token
    });

    const html = await submitRes.text();
    const verified = html.includes('Success') || html.includes('verificado');

    return {
        success: verified,
        token_length: token.length,
        message: verified ? 'CAPTCHA verificado con éxito!' : 'Verificar respuesta',
        response_preview: html.substring(0, 300)
    };
}

return await solveAndSubmit(params.website_url, params.website_key);

Esta herramienta:

1. ✅ Resuelve reCAPTCHA v2
2. ✅ Envía el token mediante una solicitud POST
3. ✅ Devuelve el estado de verificación

Mejores prácticas

1. Manejo de errores

Siempre verifica errores en cada paso:

if (createData.errorId !== 0) {
    return { success: false, error: createData.errorDescription };
}

2. Verificar saldo

Crea una herramienta separada para monitorear tu saldo de CapSolver:

const CAPSOLVER_API_KEY = '{{secrets.capsolver_api_key}}';

async function checkBalance() {
    const response = await fetch('https://api.capsolver.com/getBalance', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ clientKey: CAPSOLVER_API_KEY })
    });

    const data = await response.json();

    return {
        balance: data.balance,
        formatted: '$' + data.balance.toFixed(4)
    };
}

return await checkBalance();

3. Configuración de tiempo de espera

El tiempo de espera predeterminado es de 60 intentos × 2 segundos = 2 minutos. Ajusta si es necesario:

// Para un tiempo de espera más rápido (30 segundos)
for (let i = 0; i < 15; i++) {
    await new Promise(function(resolve) { setTimeout(resolve, 2000); });
    // ...
}

Conclusión

La integración de CapSolver con Relevance AI permite flujos de trabajo de automatización poderosos que pueden manejar formularios protegidos por CAPTCHA. Las principales ventajas son:

• No se requiere automatización de navegador - Funciona mediante llamadas a API puras
• Rápido y confiable - La IA de CapSolver resuelve CAPTCHAS en segundos
• Fácil de implementar - Solo JavaScript en el Tool Builder de Relevance AI
• Escalable - Manejar múltiples solicitudes sin preocupaciones por infraestructura

Al combinar las capacidades de los agentes de Relevance AI con la resolución de CAPTCHA de CapSolver, puedes construir flujos de trabajo de automatización completos que manejen incluso los formularios más protegidos.

¿Listo para comenzar? Regístrate en CapSolver y usa el código de bonificación RELEVANCE para obtener un 6% adicional en tu primera recarga!

Preguntas frecuentes

¿Qué es Relevance AI?

Relevance AI es una plataforma para construir agentes de IA que automatizan tareas empresariales. Ofrece un Tool Builder donde puedes crear herramientas de automatización personalizadas usando JavaScript, Python o llamadas a API.

¿Hace Relevance AI automatización de navegadores?

No. Relevance AI funciona mediante llamadas a API, no mediante automatización de navegadores. No puede abrir navegadores, hacer clic en botones ni inyectar JavaScript en páginas. Sin embargo, puede realizar solicitudes HTTP para enviar formularios con tokens de CAPTCHA.

¿Cómo se integra CapSolver con Relevance AI?

Crea una herramienta de JavaScript en Relevance AI que llame a la API de CapSolver. La herramienta envía los detalles del CAPTCHA a CapSolver, recibe un token resuelto y luego puede enviar ese token a un formulario objetivo mediante una solicitud POST.

¿Qué tipos de CAPTCHAS puede resolver CapSolver?

CapSolver soporta reCAPTCHA v2, reCAPTCHA v3, Cloudflare Turnstile, AWS WAF y muchos más.

¿Cuánto cuesta CapSolver?

CapSolver ofrece precios competitivos por resolución. Visita capsolver.com para ver los precios actuales.

¿Cómo encuentro la clave del sitio reCAPTCHA?

Busca el atributo data-sitekey en el elemento reCAPTCHA en el HTML de la página. Es una cadena de 40 caracteres que comienza con 6L. Consulta este guía

¿Cuánto tiempo tarda en resolver un CAPTCHA?

Normalmente 10-30 segundos para reCAPTCHA v2. La herramienta consulta cada 2 segundos hasta que la solución esté lista.